home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr26 / ddirv91.zip / DDIR91.DOC < prev    next >
Text File  |  1993-07-03  |  15KB  |  321 lines
  1.   
  2.                                                    
  3.                                       DDIR       ▌
  4.                                                  ▌
  5.                                    Version 9.1   ▌
  6.                                                  ▌
  7.                                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  8.  
  9.      Note: this package contains the following files, zipped with PKZIP 2.04g:
  10.  
  11.                      DDIR91.EXE
  12.                      DD91CFG.COM
  13.                      DDIR91.DOC
  14.  
  15.    ************************************************************************      
  16.    NOTE: Some BBS reject uploads if they find duplicate file names. Hence
  17.    this package contains DDIR91.EXE.  It is suggested that you rename this
  18.    to DDIR.EXE.
  19.    ************************************************************************
  20.  
  21.  
  22. DDIR
  23.  
  24. Purpose: gives a forward/backward scrollable double-column directory display.
  25.          Protected files are flagged with a "+", system files with a "$",
  26.          hidden files with a "*".  Files created today are shown in a
  27.          different color.  Toggles d, t, w and x allow rapid on-screen display
  28.          of file size as reported by DOS, the total space required to store
  29.          the file, the dead space "wasted" by the file, and the file "storage    
  30.          efficiency"  which is simply the ratio of file size to space actually   
  31.          required for storing the file. (Depending on your DOS version and/or    
  32.          hard drive type, a certain minimum amount of space is required for all  
  33.          files.  For example, a 10 byte batch file may actually use 32kb of
  34.          your network drive! The dead space is the amount of disk space wasted
  35.          by a file.)  
  36.  
  37.          DDIR allows to mark files for deletion, and to view files using the
  38.          author's VIEW utility and Vernon Buerg's LIST utility.  You can
  39.          also change directories from within the file list.
  40.          DDIR reports as a summary total file size, total space actually
  41.          for the file(s) specified. TAKE A LOOK AT THE STORAGE
  42.          EFFICIENCY FOR THOSE SMALL BATCH FILES!!
  43.  
  44.          DDIR allows you to sort directory listings alphabetically,
  45.          by size, extension, age, attribute or storage efficiency, and to        
  46.          instantly (well, almost!) resort or reverse the sort order.
  47.          For lists that require more than one screen, you can also scroll
  48.          back and forth.
  49.  
  50.          You can toggle write-protect on and off for files (i.e. make them
  51.          read-only or read-and-write).
  52.  
  53.          Please note that DDIR reports the count of files and
  54.          subdirectories separately, unlike the DOS dir command.
  55.  
  56.  USAGE
  57.  
  58.  Notes:   Use the same way as the DOS dir command.  Wild-card characters are
  59.           allowed.
  60.  
  61. Usage:    ddir [d:][path][file.ext]
  62.  
  63. Examples: directory of current drive and directory     ddir
  64.           list of .COM files on drive a -              ddir a:*.com
  65.           list of files of directory "one', drive c -  ddir c:\one
  66.  
  67.  
  68. Keys:
  69.  
  70.  F1  - help screen
  71.  Esc - exit
  72.  Tab - change bottom display (file count summary or quick help)
  73.  n   - sort by name
  74.  a   - sort by age
  75.  s   - sort by size
  76.  e   - sort by extension
  77.  f   - sort by file attribute (system, hidden, directory etc.)
  78.  %   - sort by file "storage efficiency" 
  79.  r   - reverse sort order
  80.  c   - toggle upper/lower case display
  81.  d   - show file size reported by DOS
  82.  w   - show file "wasted space"
  83.  t   - show file total space
  84.  x   - show DOS file size, wasted space and individual storage efficiency
  85.  +   - toggle file protect/unprotect (i.e. read-only or read and write)
  86.  p   - print list to file or printer
  87.  u   - interface to user-defined batch file DDIRCUST.BAT.  When you press u
  88.        the directory listing is copied to a file called DDIRUSER.FIL. You can
  89.        process this file via DDIRUSER.BAT.  The recommended use is to print
  90.        the directory list in two columns using Tony Caine's 2COL or JETCOL
  91.        programs.  For example, to use JETCOL the DDIRCUST.BAT might look like:
  92.  
  93.               c:\jetcol\jetcol ddiruser.fil
  94.  
  95.        When processing is completed the DDIR display is restored and
  96.        DDIRUSER.FIL is deleted.
  97.  
  98.  Up arrow   - scroll up one file
  99.  Down arrow - scroll down one file
  100.  PgDn       - next screen
  101.  PgUp       - previous screen
  102.  Home       - go to beginning of list
  103.  End        - go to end of list
  104.  
  105.  Right arrow - move down current screen list to select "active" file
  106.  Left arrow  - move up current screen list to select "active" file
  107.  Del         - mark/unmark file for deletion (Del is a toggle)
  108.  Enter       - change to highlighted directory
  109.  v           - view highlighted file with VIEW (for WordPerfect 5.0-5.2,
  110.                DOS Word 4-5.5, WinWord 1-2, Win Write, ASCII)
  111.  l           - view highlighted file with LIST (by Vernon Buerg)
  112.  
  113.  Notes: To use v or l you must have the VIEW or LIST utilities in a directory
  114.         referenced in your AUTOEXEC.BAT PATH statement).
  115.  
  116.         When you press the right or left arrow keys, the up and down arrow
  117.         keys are disabled. To re-enable, press Spacebar, PgUp, PgDn, Home
  118.         or End
  119.  
  120.  
  121.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  122.  
  123.       DDIR is an EXE file.  If you are upgrading from an earlier COM
  124.       version, be sure to delete DDIR.COM.
  125.    
  126.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  127.  
  128.           ** NEW IN VERSION 9.0b ***
  129.  
  130.           Version 9.0 is a major upgrade. In addition to all the previous
  131.           features it has the following:
  132.            print list
  133.            delete file(s)
  134.            view files
  135.            change directory
  136.            two help screens (accessed by F1)
  137.            interchangeable bottom-screen summary/help display
  138.  
  139.           ** NEW IN VERSION 9.1 ***
  140.  
  141.           Version 9.1 adds the ability to sort by file storage efficiency and     
  142.           adds the display of individual storage efficiency when the "x" key
  143.           is pressed. It also allows you to toggle file protection (i.e. read-
  144.           only or read-and-write), using the + (or =) key. Finally, the
  145.           highlighted file function now scrolls you to the next or previous
  146.           screen.
  147.          
  148.  
  149. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  150.  
  151.  
  152. CUSTOMIZING DDIR WITH DD91CFG.COM
  153.  
  154. Usage: dd91cfg [filename]
  155.                where filename is ddir.exe or a copy of ddir.exe
  156.                given some other .exe name (e.g. dd91.exe) 
  157.  
  158.  
  159. NOTE: the customization now allows you to save your settings to a file
  160. DDIR9CFG.SAV.  You can have different versions of this file in different
  161. directories if you wish; DDIR will use the settings it finds in the directory
  162. it is run from, if a SAV file exists there.  otherwise it will use its
  163. customized default settings.  You can also reconfigure the default
  164. customization for DDIR from any SAV file you have previously created.  This
  165. feature will be maintained, if possible, in any future upgrades of DDIR,
  166. so that you will be able to reconfigure future versions automatically using
  167. the preferences you have established now.
  168.  
  169. The display colors, the date and time format and the default display (upper
  170. or lower case) can be set automatically using the accompanying configuration
  171. program DD91CFG.BEFORE CUSTOMIZING, MAKE SURE YOU HAVE BACKED UP THE ORIGINAL
  172. DDIR.EXE TO A SAFE PLACE!  Then from the directory where you have ddir.exe
  173. simply type   dd91cfg or dd91cfg ddir.exe (where ddir.exe can be replaced
  174. with a copy of ddir.exe renamed to some other executable e.g. dd91.exe). 
  175. Follow instructions.  If you choose to reconfigure ddir.exe (or the copy)
  176. directly, a modified file called DDIR91N.EXE, using your selected
  177. customizations, will be created.  Test this before using the DOS COPY
  178. command to copy it to ddir.exe.
  179.  
  180. You can also just create a new DDIR9CFG.SAV configuration file, or reconfigure
  181. ddir.exe from an existing DDIR9CFG.SAV file (including those created from 
  182. earlier versions).
  183.  
  184. If you choose to modify the executable, rather than just create a new
  185. configuration file, DD91CFG will try to open the file you specify on the
  186. command line, or, if none is given, will try to open DDIR.EXE.
  187.  
  188. The first set of customizations are for the display colors. You can then set
  189. the mode of date display (e.g. dd.mm.yy, mm-dd-yy etc.) and the default sort
  190. method when DDIR is run.
  191.  
  192. DDIR can, if your display adapter is appropriate, use fast screen display.
  193. Unless you are using a CGA adapter or VGA in a slow computer, you should
  194. be able to use this mode.  However, because some adapters are non-standard
  195. it is possible that running in fast display mode would lock your system. 
  196. DDIR therefore ships with the default normal display speed.  You can modify
  197. this through DD91CFG.  If doing so causes no problems stay with it; if a
  198. problem does arise, re-run DD91CFG and select normal display speed.
  199.  
  200. Some non-standard BIOSes do not correctly return the number of lines being
  201. used on the display screen (25 on CGA; up to 60 on VGA displays).  Although
  202. DDIR tries to detect abnormal results, you can, as an added precaution, force
  203. it to use only 25 lines.  Normally,  select "let DDIR choose", and force it
  204. to 25 lines only if there is a problem with the display.
  205.  
  206.                              *** IMPORTANT ***
  207.  
  208. The author makes no warranty that the software in this package
  209. will work with your particular hardware configuration.  You use the
  210. programs entirely at your own risk, and the author will not be held
  211. liable for any damage caused to your hardware or software through
  212. use of this software, or for any other effects, direct or indirect,
  213. of using the software.
  214.  
  215. Legalities aside, you should not run into difficulties with this
  216. software.
  217.  
  218.  
  219.                           **** SHAREWARE ****
  220.  
  221.  
  222. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
  223. (Editorial note: I don't support "crippleware" - I want to know
  224. EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
  225. like test driving a Mercedes that's been fitted with a two-stroke engine!
  226. There, that's said - but each to his own.)
  227.  
  228. You do not have to register as a user, nor are you under any
  229. obligation to buy the program(s).  However, they are not free, and in
  230. the spirit of shareware, you are requested to make a small
  231. donation to the author if you find the software in this package useful,
  232. and if you continue to use it after an evaluation period of 30 days. This
  233. would both fulfil your moral obligation and help ensure the viability of
  234. the shareware concept, from which we all benefit. If you choose not to pay,
  235. you are asked to remove the program files from your computer.
  236.  
  237. The suggested contribution is $15 but less (or more!) would be fine. Pay what
  238. you think the software is worth to you. If you pay the recommended amount PLUS
  239. ADD $4 for shipping and handling, I will send you a 5 1/4" diskette with the
  240. latest version plus a selection of other shareware (my own and the best from
  241. other authors, including 2COL/JETCOL by Tony Caine). Alternatively, send a
  242. blank diskette of your preferred size (5 1/4" 360kb or 1.2Mb, or 3 1/2" 720kb
  243. or 1.4 Mb) plus $3 s&h.
  244.  
  245. Should you decide to make a contribution, please remit to:
  246.  
  247.                    Malcolm Drury
  248.                    11 Adele Crescent
  249.                    Nepean
  250.                    ON  K2J 2T7
  251.                    Canada
  252.  
  253. Internet drury@gsc.emr.ca
  254. Compuserve 70574,3457
  255.  
  256. Bank notes would be fine!  Thank you. Please tell me where you
  257. got the software from (this helps me in knowing where to post updates), and,
  258. most importantly, which version it is.
  259.  
  260.  
  261. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION  -  THANKS, AND
  262. OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
  263. ETC. ARE ALWAYS WELCOME.
  264.  
  265. Please note that at the low contribution requested, I cannot provide direct
  266. technical support, nor automatically send upgrades, should they
  267. become available. If you have comments, questions, bug reports etc., please
  268. leave a message at my Compuserve or INTERNET address, or write to me via
  269. snail mail. I will endeavor to fix any problems you might encounter.
  270.  
  271. The software is supplied on an "as is" basis. You are free to distribute
  272. this software package provided that you distribute the ENTIRE package,
  273. including this documentation file. (This is necessary for others to be able
  274. to use it properly.  I've downloaded too many shareware packages that had
  275. been posted without accompanying documentation!).
  276.  
  277. I hope you find this package useful.
  278.  
  279.  
  280. Malcolm Drury
  281. June 9, 1993
  282.  
  283.  
  284. HOW TO OBTAIN VIEW
  285.  
  286. VIEW is available on many BBS and on Compuserve/Ziffnet (VWFILE.ZIP
  287. in ZNT:TIPS).  If you wish to obtain a copy directly form me, please add $15
  288. to your contribution. Alternatively, get it from your BBS and "try before you
  289. buy" just as you are doing with DDIR.  From your favorite BBS just do a search
  290. on "VIEW??.*"
  291.  
  292. ********************************************************************************
  293.  
  294.             Look for the following shareware on this BBS
  295.  
  296. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  297.              than 260,000 colors! (And see how many you can actually discern!).
  298.              One palette can be used to create a small (2k) TSR program that
  299.              maintains your chosen scheme.  Alternatively, you can set any of
  300.              the palettes, or a grey-scale scheme, from a non-TSR if
  301.              memory or loading a TSR is a problem.
  302.  
  303. DSPACE61.ZIP - shows graphically hard disk space installed, used and free,
  304.                for all drives, and shows drive type (local, remote, RAM etc.);
  305.                second program shows graphically space on designated drive
  306.                (including floppy), and reports on installed and available
  307.                RAM, including XMS and EMS memory.
  308.  
  309. VIEW82.ZIP - file viewer for WordPerfect 5.0 - 5.2, ASCII and Word (DOS 4/5
  310.               and Windows 1/2); includes text search, printing full or partial
  311.               file, etc.  (On Compuserve as VWFILE.ZIP in ZNT:TIPS)
  312.  
  313.  
  314. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE! I'LL BE HAPPY TO SEND THEM
  315. TO YOU, BUT IN THE INTERESTS OF CUTTING DOWN CONNECT TIME WOULD PREFER TO USE
  316. INTERNET. THAT WOULD REQUIRE YOU TO HAVE THE UUDECODE.EXE PROGRAM, WHICH SHOULD
  317. BE AVAILABLE ON ANY BBS YOU USE.
  318.  
  319. CIS 70574,3457
  320. INTERNET drury@gsc.emr.ca
  321.